home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / HENSA / MISC / SENDMAIL.ARC / doc / sendmail < prev   
Encoding:
Text File  |  1993-10-04  |  4.3 KB  |  145 lines
  1.  
  2.   SENDMAIL - a simple mail delivering interface 
  3.   ---------------------------------------------
  4.  
  5.  
  6.  
  7. *************
  8. Copyright
  9.  
  10. Sendmail's copyright is by Thomas Aeby
  11. You may freely distribute sendmail - DO IT!
  12.  
  13.  
  14.  
  15. *************
  16. What is sendmail?
  17.  
  18. Sendmail is a tiny little program that serves as an interface between
  19. mailers and low level mail delivering programs. It's task is to read mail
  20. passed by another program and apply one of the existing mail delivering
  21. methods depending on the message's destination address. Sendmail is not
  22. intended to be invoked directly by the user - this is the task of mailers -
  23. but can be used this way of course.
  24.  
  25.  
  26.  
  27. *************
  28. Why should we use sendmail on Archimedes?
  29.  
  30. I am tired with things like
  31.   - use one mailer for !UUCP, another for !TCPIP, ...
  32.   - reinvent wheel each time I write a program that should automatically send
  33.     messages
  34. Until now every one who wrote a mailer (such as ArcBM for instance) or a
  35. mail delivery system (such as !RUCP or !TCPIP) put the corresponding method
  36. passing mail from the user to the mail delivery system into the mailer. So
  37. we have now a lot of great mailers but none of it is compatible with all the
  38. mail delivery systems. And have you ever tried to use UUCP and TCPIP on the
  39. same machine? With sendmail you can send your mail without knowing which
  40. system is actually used for delivery. As soon as every mail system uses
  41. sendmail they are all compatible!
  42.  
  43.  
  44. *************
  45. How to use sendmail
  46.  
  47. The syntax used to invoke sendmail is
  48.  
  49.   sendmail [-f file] [-C file] [address1] [address2] ...
  50.  
  51. When called sendmail reads one message from stdin (from a file passed with
  52. -f option resp.). This message MUST contain a valid mail header. Then
  53. sendmail searches for the destination addresses. If one or more address is
  54. given on the command line then mail is sent to this/these addresse(s). If
  55. not the addresse(s) are extracted from the To: line in the mail header. Each
  56. of the addresses is looked up in sendmail's configuration file and the
  57. corresponding mail delivery methods are called.
  58.  
  59. Sendmail expects it's configuration file to be
  60.   - the file passed with the -C option ('override configuration file')
  61.   - the file indicated with the environment variable sendmail$config
  62.   - the file 'mailer' in the current directory
  63.  
  64.  
  65. *************
  66. The configuration file (see also the sample configuration file)
  67.  
  68. Each line of the configuration file contains (from left to right)
  69.  
  70.    1. a (wildcarded) mail address
  71.    2. a space
  72.    2. the method (command) that delivers messages to this address
  73.  
  74. wildcards are '*' and '?'. '?' matches exactly one character, '*' zero
  75. or more characters.
  76.  
  77. The command may contain % expressions. They are replaced by sendmail by
  78. different strings:
  79.  
  80.    %f name of the file containing the message (with headers)
  81.    %t destination address (as given on sendmails command line
  82.       or extracted from the message header)
  83.    %<digit> string that is matched by the corresponding '*' or '?'
  84.       wildcard. If the wildcarded mail address is *@*.ch and the actual
  85.       address is root@nic.switch.ch then %0 is replaced by 'root'
  86.       and %1 by 'nic.switch'
  87.  
  88. sendmail is CASE SENSITIVE
  89.  
  90. Sample:
  91.  
  92.   the configuration file contains the line
  93.     *@*.UUCP uux < %f - master!rmail %0@%1
  94.   then sendmail is invoked as
  95.     sendmail postmaster@sub.master.UUCP
  96.   and the message entered at the console
  97.     To: postmaster@sub.master.UUCP
  98.     From: aeby@dial.eunet.ch
  99.     Subject: test sendmail
  100.  
  101.     test
  102.     ^D
  103.   sendmail reads the console input into a temporary file - let's call it TMP000
  104.   sendmail then does find out that 'postmaster@sub.master.UUCP' does match
  105.   *@*.UUCP and therefore does invoke the corresponding method, means
  106.     uux < TMP000 - rmail postmaster@sub.master
  107.   The mail is delivered by UUCP - Voila
  108.  
  109.  
  110.  
  111.  
  112. *************
  113. mail delivery systems provided
  114.  
  115. Until now there are 2 mail delivery programs supplied
  116.  
  117.   1. smtpqueue  (smtpqueue address origin-address)
  118.      for !TCPIP mail delivery
  119.   2. putmail    (putmail username)
  120.      for !BM compatible mail delivery
  121.  
  122. Many mail systems have their own low level methods already included - take
  123. UUCP for instance: here mail is sent by UUX
  124.  
  125.  
  126.  
  127. *************
  128. sendmail and rmail
  129.  
  130. I use on my system
  131.  
  132.   Set alias$rmail "sendmail "
  133.  
  134.  
  135.  
  136.  
  137.  
  138. Thomas Aeby
  139. Graeffet 406
  140. 1735 Giffers
  141. Switzerland
  142. +41 37 38 16 00
  143. Internet: aeby@dial.eunet.ch
  144. Fidonet : Thomas Aeby, 2:301/811.49@fidonet.org
  145.